home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 14 / Mac Magazin and MacEasy Magazine CD - Issue 14.iso / Wissenschaft & Technik / Tools Plus 2.6.1 Evaluation Kit / Tools Plus 2.6.1 / User Manual / 05-Windows (3 of 3) < prev    next >
INI File  |  1994-09-17  |  5KB  |  110 lines
  1. [Display using Monaco 9]
  2.  
  3.  
  4.  
  5. WorkWindowNumber
  6. ````````````````
  7. Get the window number of your application’s work window.
  8.  
  9.    pascal short WorkWindowNumber(void);
  10.  
  11.    function WorkWindowNumber: INTEGER;
  12.  
  13.   This function returns the window number of your application’s work window.  Your application has only one such window which gains its “work window” status under any of the following conditions:
  14.  
  15.    • the user clicks in a window, or any object in a window
  16.  
  17.    • a window is opened as modal (because the next action must take
  18.      place within that window)
  19.  
  20.    • a standard window is opened (and therefore activated), and the
  21.      previous work window was an active standard window
  22.  
  23.    • the work window is closed or hidden, in which case the following
  24.      will become the work window:
  25.         front most standard window (if any are open), or
  26.         front most floating palette (if any are open), or
  27.         the tool bar (if it is open)
  28.  
  29.    • a window is activated
  30.  
  31.   Your application can treat a work window like an active window, in that it is an eligible target for the user’s activity.  If your application does not use a tool bar or floating palettes, the work window is the same as the active window.
  32.  
  33. ------------------------------------------------------------------------
  34.  
  35. EditFldWindowNumber
  36. ```````````````````
  37. Get the window number of the window containing your application’s active editing field.
  38.  
  39.    pascal short EditFldWindowNumber(void);
  40.  
  41.    function EditFldWindowNumber: INTEGER;
  42.  
  43.   This function returns a window pointer to a Tools Plus window regardless if it is open or not.
  44.  
  45.   This function returns the window number of the window containing the active editing field in your application.  If your application does not have a tool bar or floating palettes, this window will either be the active window (front most), or it will be zero (0) when there is no active field.  When a tool bar and/or floating palettes are used, this window can potentially be any of the active windows (tool bar, any floating palette, or the active standard window).  See the Editing Fields chapter for details.
  46.  
  47. ------------------------------------------------------------------------
  48.  
  49. WindowIsOpen
  50. ````````````
  51. Determine if a window is open.
  52.  
  53.    pascal Boolean WindowIsOpen (short Window);
  54.  
  55.    function WindowIsOpen (Window: INTEGER): BOOLEAN;
  56.  
  57.   Window is the window number of a Tools Plus window.  Window must be less than or equal to MaxWindows as defined by InitToolsPlus.
  58.  
  59.   The function’s value returns true if the window is open, and false if the window is not open.  Note that an open window may have been hidden by your application, and therefore not be visible.
  60.  
  61. ------------------------------------------------------------------------
  62.  
  63. WindowIsVisible
  64. ```````````````
  65. Determine if a window is visible (not hidden).
  66.  
  67.    pascal Boolean WindowIsVisible (short Window);
  68.  
  69.    function WindowIsVisible (Window: INTEGER): BOOLEAN;
  70.  
  71.   Window is the window number of a Tools Plus window.  Window must be less than or equal to MaxWindows as defined by InitToolsPlus.
  72.  
  73.   The function’s value returns true if the window is open and visible, and false if the window is not open or not visible.  The term “visible” refers to being programatically unhidden.  It does not mean “obscured by other windows or objects.”
  74.  
  75. ------------------------------------------------------------------------
  76.  
  77. WindowKind
  78. ``````````
  79. Determine a window’s type.
  80.  
  81.    pascal short WindowKind (short Window);
  82.  
  83.    function WindowKind (Window: INTEGER): INTEGER;
  84.  
  85.   Window is the window number of a Tools Plus window.  Window must be less than or equal to MaxWindows as defined by InitToolsPlus.  The window may be hidden.
  86.  
  87.   The function with a value that corresponds to the type of window being referenced.  The four constants that can be used to evaluate a window’s type are wNoKind (window is not open), wToolBarKind, wFloatingKind, and wStandardKind.
  88.  
  89. CONST                     {Kinds of windows:             }
  90.     wNoKind       = 0;    {Not open                      }
  91.     wToolBarKind  = 1;    {Tool Bar                      }
  92.     wFloatingKind = 2;    {Floating Palette              }
  93.     wStandardKind = 3;    {Standard Window               }
  94.  
  95. ------------------------------------------------------------------------
  96.  
  97. WindowPointer
  98. `````````````
  99. Get the pointer to a Tools Plus window.
  100.  
  101.    pascal WindowPtr WindowPointer (short Window);
  102.  
  103.    function WindowPointer(Window: INTEGER): WindowPtr;
  104.  
  105.   This function returns a window pointer to a Tools Plus window regardless if it is open or not.
  106.  
  107.   Window is the window number of a Tools Plus window.  Window must be less than or equal to MaxWindows as defined by InitToolsPlus.  If it is not, nil is returned.
  108.  
  109. ------------------------------------------------------------------------
  110.